home *** CD-ROM | disk | FTP | other *** search
/ DS-CD ROM 2 1993 August / DS CD-ROM 2.Ausgabe (August 1993).iso / utility / ds0360 / pb32.exe / HANDBUCH.DOK < prev    next >
Text File  |  1992-10-19  |  58KB  |  1,298 lines
  1.  
  2.  
  3.   ███████ ███████ ███████ ██████ ██ ██████    █████  ████████ ███████ ██   ██
  4.   ██   ██ ██   ██ ██   ██ ██     ██ ██  ██   ██   ██    ██    ██      ██   ██
  5.   ██   ██ ██   ██ ██   ██ ██     ██ ██  ██   ██   ██    ██    ██      ██   ██
  6.   ███████ ███████ ██   ██ █████  ██ ████████ ███████    ██    ██      ███████
  7.   ██      ██ ██   ██   ██ ██     ██ ██    ██ ██   ██    ██    ██      ██   ██
  8.   ██      ██  ██  ██   ██ ██     ██ ██    ██ ██   ██    ██    ██      ██   ██
  9.   ██      ██   ██ ███████ ██     ██ ████████ ██   ██    ██    ███████ ██   ██
  10.  
  11.                     (c) 1991,1992 by W. Andreas Pollack
  12.                          Alle Rechte vorbehalten.
  13.  
  14.                              Version: 3.2
  15.                   Handbuch überarbeitet von: Eduard Klein
  16.  
  17.  
  18.   Willkommen zu PROFIBATCH!
  19.  
  20.   Sicher werden Sie fragen: "Was ist denn PROFIBATCH?"
  21.  
  22.   PROFIBATCH ist  ein kleines,  aber überaus  hilfreiches Werkzeug,  was Sie
  23.   besonders schön  in Batch-Programmen  einsetzen können! Die Funktionsweise
  24.   ist  schnell   beschrieben:  PROFIBATCH   präsentiert   in   ASCII-Dateien
  25.   gespeicherten Text in anspruchsvoller Weise auf dem Bildschirm.
  26.   Das heißt:  Schreiben Sie einen Text, speichern Sie ihn im ASCII-Format an
  27.   und überlassen  Sie es PROFIBATCH, den Text ansprechend auf den Bildschirm
  28.   zu zaubern.
  29.   Fangen Sie  doch gleich  mal an:  Angenommen Sie haben Ihren Text (er darf
  30.   allerdings nicht  breiter als  76 und  nicht höher  als 23  Zeichen sein!)
  31.   HALLO.DOC genannt. Dann geben Sie ein: PB hallo.doc.
  32.   Und was  geschieht? NA  also, so  leicht geht das. Sie werden sich denken,
  33.   das das nicht alles ist!
  34.   Es  finden   sich  bei   PROFIBATCH  auch  noch  eine  Vielzahl  kleinerer
  35.   Besonderheiten, die der Batch-Programmierer meistens vermißt.
  36.  
  37.   Als da wäre:
  38.   » PopUp / PopDown Möglichkeiten!
  39.   » Jedes Fenster beliebig einfärben!
  40.   » Volle Zugriffsmöglichkeit auf die Bildschirmfarben!
  41.   » Texte mit Schatten ausgeben!
  42.   » Warnton!
  43.   » Volle Positioniermöglichkeit im Bildschirmmodus 80x25!
  44.   » Wartezeit beim Präsentieren!
  45.   » Texte als Menüs!
  46.   » Überschriften in die Textfenster!
  47.   » Obligatorischen Tastendruck abwarten!
  48.   » Umgebungsvariablen vom Kommando-Prozessor lesen, schreiben, präsentieren
  49.     und editieren!
  50.   » Setzen von Fehlercode zur Abfrage mit ERRORLEVEL!
  51.   » Die wichtigsten MAUS Funktionen!
  52.   » Abarbeitung  von   bis   zu   500   Texten/Einträgen   durch   spezielle
  53.     Quelldateien.
  54.   » Erstellen und  Erweitern eigener  Bibliotheken,  die  zusammen  mit  dem
  55.     Runtime-Programm weitergegeben werden dürfen! 
  56.  
  57.   Ist das  nichts? Und  ich kann  Ihnen sagen: Das ist NUR die Funktion! Sie
  58.   sind z.B.  als lebendiges Wesen geschaffen und Sie kennen Ihre Funktionen,
  59.   aber Sie  und ich  wissen, was  man daraus  alles machen  kann; und darauf
  60.   können Sie gespannt sein...
  61.  
  62.  
  63.   Unterschiede zur Version 3.0x:
  64.   ──────────────────────────────
  65.   Version 3.2 wurde von folgenden Fehlern befreit:
  66.  
  67.   -  Option  /c   arbeitete  weder   in  Quelldateien,  noch  in  erstellten
  68.      Bibliotheken korrekt.
  69.   -  Quelldateien, die  am Ende  noch Leerzeilen  angefügt haben,  förderten
  70.      konsequent Fehler zu Tage.
  71.   -  Beim Dienstprogramm  BAT2Q.EXE arbeitete die Option /s nicht korrekt.
  72.  
  73.  
  74.   Die Diskette beinhaltet folgende Dateien:
  75.   ─────────────────────────────────────────
  76.  
  77.   PB.EXE     PROFIBATCH-Programm.
  78.  
  79.   Diese Datei  ist der  KERN! Alles  andere sollten  Sie zu  Beginn  getrost
  80.   vergessen. Wenn  Sie  sich  in  Batch-Programmierung  noch  nicht  richtig
  81.   auskennen, kann ich Ihnen nur empfehlen: Lernen Sie's! Die 10 Befehle sind
  82.   schnell gelernt und zusammen mit den ca. 20 Optionen von PROFIBATCH können
  83.   Sie sich's  zu Hause gemütlich machen... Und Ihre Kollegen werden staunen:
  84.   Was Sie programmieren können!
  85.   Am besten  Sie arbeiten  erst einmal  mit PB  und erstellen  Ihre  eigenen
  86.   Texte. Probieren  hier etwas  und dort, verwenden diese Option und jene...
  87.   Viel falsch können Sie sowieso nicht machen...
  88.   Eine Anleitung zu den ersten Schritten finden Sie weiter unten.
  89.  
  90.  
  91.   Dienstprogramme:
  92.   ────────────────
  93.     USELIB.COM   Runtime-Programm für die Bibliotheken.
  94.       INFO.BAT   Umfassendes Informationssystem.
  95.       INFO.LIB   Textbibliothek für INFO.BAT.
  96.    INSTALL.BAT   Installiert alle Dateien auf der Festplatte.
  97.    INSTALL.LIB   Textbibliothek für INSTALL.BAT.
  98.  
  99.   Manche Leute lesen keine Dokumentationen. Wenn SIe auch dazu gehören, dann
  100.   ist INFO.BAT  vielleicht gerade  das Richtige  für  Sie!  Lernen  Sie  mit
  101.   INFO.BAT interaktiv die Möglichkeiten von PROFIBATCH kennen.
  102.   INSTALL.BAT tut das, was der Name verspricht...
  103.  
  104.   Dokumentationen:
  105.   ────────────────
  106.   HANDBUCH.DOK   Diese Datei hier.
  107.     WASIST.NEU   Beschreibt etwaige Erneuerungen und Erweiterungen.
  108.    HISTORY.DOK   Entstehungsgeschichte von PROFIBATCH.
  109.     FEHLER.DOK   Hinweise  auf  Fehler,  die  von  Anwendern  zurückgemeldet
  110.                  wurden.
  111.    BESTELL.DOK   Hinweise zur Registrierung.
  112.    BESTELL.FRM   Bestellformular
  113.  
  114.  
  115.   Der PROFIBATCH-Developer:
  116.   ───────────────────────────────────────────────────
  117.      PBLIB.SRC   Runtime-Code für die Programmentwicklung.
  118.        PBD.BAT   Die Entwicklungsumgebung (ab DOS 3.3).
  119.       PBDL.LIB   Bibliothek für die Entwicklungsumgebung.
  120.      INDEX.BAT   On-Line-Hilfe.
  121.      INDEX.LIB   Bibliothek für die HILFE.
  122.     CONFIG.STD   Konfigurationsmusterdatei.
  123.   PBDCONFG.BAT   Standard-Konfigurationsdatei.
  124.  
  125.   Dienstprogramme für die Developers-Version:
  126.   ───────────────────────────────────────────
  127.    LIB2TXT.EXE   Konvertierprogramm für Bibliotheken.
  128.      BAT2Q.EXE   Hilfsprogramm für Batch Programme.
  129.  
  130.   Diese Dateien  demonstrieren v.a.  die Mächtigkeit  des kleinen  PB.EXE  -
  131.   Kerns! Es  nennt sich  Entwicklungsumgebung und wird mit "PBD" aufgerufen.
  132.   Für den Neuankömmling ist diese Oberfläche jedoch gewöhnungsbedürftig, was
  133.   die Arbeit  manchmal weniger  erleichtert (was  es  eigentlich  soll)  als
  134.   erschwert. Jedoch:  Sie sehen  an PBD.BAT,  wie leistungsfähig  PROFIBATCH
  135.   ist, denn  die Entwicklungsumgebung  wurde einzig  und  allein  mit  einem
  136.   Texteditor  und   PROFIBATCH  erstellt!  Eine  eigene,  von  Ihnen  selbst
  137.   erstellte  Entwicklungsumgebung   sehen  wir   also  bereits  am  Horizont
  138.   aufblinken!
  139.  
  140.  
  141.   Garantie:
  142.   ─────────
  143.   Als Autor  gebe ich  keinerlei Garantien bezüglich der Verwendbarkeit oder
  144.   Nichtverwendbarkeit für  irgendeinen Zweck.  Weiterhin übernehme ich keine
  145.   Verpflichtungen für    den  Gebrauchswert    dieser    Software  über  den
  146.   Kaufpreis hinaus.  Unter keinen  Umständen bin   ich  haftbar für  jedwede
  147.   Folgeschäden,   einschließlich    aller       entgangenen   Gewinne    und
  148.   Vermögensverluste, oder  anderer mittelbarer   und  unmittelbarer Schäden,
  149.   die durch  den Gebrauch  oder die  Nichtverwendbarkeit dieser Software und
  150.   ihrer begleitenden   Dokumentation  entstehen. Dies  gilt auch,   wenn ich
  151.   über die Möglichkeit  solcher Schäden  unterrichtet war oder bin.
  152.  
  153.  
  154.   Das SHAREWARE-Prinzip:
  155.   ──────────────────────
  156.   Wenn Sie  Gefallen an  PROFIBATCH finden,  kopieren  Sie  doch  bitte  die
  157.   Shareware-Version und  geben Sie  sie an Freunde und Bekannte weiter. Wenn
  158.   Sie PROFIBATCH  selbst auf  Dauer  einsetzen  wollen  (was  sich  wirklich
  159.   empfiehlt! Meine ganzen Batch-Programme sähen sehr mager aus, wenn's nicht
  160.   PROFIBATCH gäbe!), sollten Sie sich registrieren lassen!
  161.  
  162.   Die registrierte Version kostet 49,- DM für private Anwender und DM 149,--
  163.   für gewerbliche Anwender. Die Vollversion ist dann von der  Zählschleife
  164.   befreit, die Sie sonst alle 50 Mal an Ihre Registrierung erinnert...
  165.   Außerdem erhalten Sie eine gedruckte Dokumentation und werden über Updates
  166.   informiert.
  167.  
  168.   Hier können Sie bestellen:
  169.   ──────────────────────────
  170.  
  171.                         ┌───────────────────────────┐
  172.                         │   KLEIN Computersysteme   │█
  173.                         │        Eduard Klein       │█
  174.                         │   Heinrich-Lanz Str. 10   │█
  175.                         │     6711 Beindersheim     │█
  176.                         └───────────────────────────┘█
  177.                          ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  178.  
  179.   Vor allem anderen:
  180.   ──────────────────
  181.   Auf der  Diskette finden  Sie die  Stapeldatei  START.BAT.  Wenn  Sie  sie
  182.   starten, erhalten Sie diverse Info-Fenster und finden sich dann irgendwann
  183.   einmal in  einem Installationsmenü.  Das ist das Programm INSTALL.BAT. Mit
  184.   INSTALL.BAT werden  alle Dateien  in ein  Verzeichnis auf Ihrer Festplatte
  185.   kopiert.   Es   empfiehlt   sich   dies   zu   tun!   Entweder   mit   dem
  186.   Installationsprogramm oder  mit dem  Copy-Befehl  von  DOS  (wenn  es  mit
  187.   INSTALL.BAT nicht funktionieren sollte...).
  188.  
  189.   !!!!ACHTUNG: Sollten  Sie anschließend  eines der  Programme INFO.BAT oder
  190.   PBD.BAT aufrufen  und  sollten  Sie  von  DOS folgende Meldung  auf  dem
  191.   Bildschirm erhalten "Environment voll", dann ist Ihre Variablen-Umgebung
  192.   nicht groß genug.
  193.   Damit das  Programm INFO.BAT  oder auch  PBD.BAT ohne Zwischenfälle laufen
  194.   kann,  muß Ihre  Variablenumgebung des Rechners genügend groß  sein. Sie
  195.   verändern die  Größe in der Datei CONFIG.SYS mit dem Eintrag:
  196.  
  197.   SHELL=C:\COMMAND.COM C:\ /P /E:1024.
  198.  
  199.   Wobei für  das Laufwerk C: natürlich auch D: oder ein anderes stehen kann,
  200.   je  nachdem  wo  sich  die  Datei COMMAND.COM befindet.
  201.   Wichtig ist  der Wert  nach dem  Parameter  /E.  In obigem Beispiel wird
  202.   die Umgebung auf 1Kb groß angesetzt. Sollten Sie nach der Eingabe SET viele
  203.   Einträge in Ihrer Umgebung vorfinden, ist unbedingt eine Vergrößerung der
  204.   Umgebung  notwendig. Dann ersetzen Sie die 1024 mit 2048 oder mehr.
  205.   Haben Sie die Datei CONFIG.SYS verändert und gespeichert, booten Sie Ihren
  206.   Rechner neu  (CTRL-ALT-DEL). Nun  wird  die  Fehlermeldung  wahrscheinlich
  207.   nicht mehr erscheinen.
  208.   Wollen Sie  die Umgebung  Ihres Rechners nicht auf DAUER verändern, können
  209.   Sie vor  dem Start  auch  eine  Shell  mit  entsprechender  Umgebungsgröße
  210.   starten. Geben  Sie dazu  vor dem  Start von  INFO.BAT oder  PBD.BAT
  211.   folgende  Zeile ein:
  212.  
  213.   COMMAND /E:1024.
  214.   Vergessen Sie jedoch NICHT nach der Sitzung, die Shell mit EXIT wieder zu
  215.   verlassen.
  216.  
  217.  
  218.  
  219.   Die Optionen im Überblick:
  220.   ───────────────────────────
  221.  
  222.   Syntax: PB [-c,-f,-g,-i] [(Quell-)Dateiname] [Optionen]
  223.   ───────
  224.   Optionen:
  225.   ─────────
  226.   -a Bibliothek erweitern             -i  Variable für Eingabe
  227.   -b  Breite des Eingabefensters      -m  Text als Menü
  228.   -c  Bildschirm löschen              -n  Variable ausgeben
  229.   -e Bibliothek erstellen             -o  Fenster ohne Tastendruck
  230.   -f  Bildschirmfarben                -p  Warnton
  231.   -g? Mausfunktionen                  -q  Datei ist Quelldatei
  232.       -gi  initialisieren             -r  Rahmen
  233.       -g1  einschalten                -s  Schatten
  234.       -g0  ausschalten                -u  Überschrift
  235.       -gl  lesen                      -v  Vordergrundfarbe für Fenster
  236.       -gs  positionieren              -w  Obligatorische Taste
  237.       -gx  vertikale Einschränkung    -x  Spalte
  238.       -gy  horizontale Einschränkung  -y  Zeile
  239.   -h  Hintergrundfarbe für Fenster    -z  Wartezeit
  240.  
  241.   Grundsätzliches:
  242.   ────────────────
  243.   1) Nach 'PB'  folgt in der DOS-Zeile (fast) immer ein Dateiname. Ausnahmen
  244.      bilden nur die Option -c, und die Schalter -f, -g, -i und -n.
  245.  
  246.   2) Auf den  Dateinamen oder  die Schalter  können immer  Optionen  folgen,
  247.      jeweils mit einem Leerzeichen getrennt.
  248.  
  249.   3) Alle Optionen  werden  mit  einem  führenden  '-'  oder  '/'  angegeben
  250.      (Beispiel: -s oder /s). Ob Groß oder Kleinschreibung, das ist egal.
  251.  
  252.   4) Sind nach  einer Option  irgendwelche Angaben zu machen (Zeile, Spalte,
  253.      Farbe, etc.),  so werden sie DIREKT an die Option angefügt (Beispiel: -
  254.      w5 oder /uHILFE).
  255.  
  256.   5) Alle Optionen  können wahllos  miteinander gemischt  werden,  wobei  es
  257.      keine Rolle  spielt, welche  zuerst angegeben  wird! Beachten Sie aber,
  258.      daß manche  Kombinationen unsinnig  sind (Beispiel: -z10 -wQ). In einem
  259.      solchen Fall  wird nach  interner Priorität  entschieden, welche Option
  260.      zur Geltung kommt.
  261.  
  262.   6) Die Optionen -e, -f, -g, -i, -n und -q sind spezielle Schalter, wobei -
  263.      f, -g,  -i und  -n  immer  am  Anfang  gleich  nach  PB  stehen  müssen
  264.      (Beispiel: PB -f -h3 -v14).
  265.  
  266.   7) Von Haus  aus sind  schon  gewisse  Voreinstellungen  ('Standardwerte')
  267.      getroffen. Das bedeutet, daß Sie also nicht immer ALLE Optionen angeben
  268.      müssen, sondern nur wenn sie die Standardwerte ÄNDERN wollen (Beispiel:
  269.      Die Angabe  -r2 können Sie sich sparen, wenn Sie einen doppelten Rahmen
  270.      wünschen.).
  271.  
  272.   8) Die zu  präsentierenden Texte  können nur  maximal EINE Bildschirmseite
  273.      (evtl. Rahmen abziehen!) groß sein.
  274.  
  275.   9) Aus einer Quelldatei kann KEINE WEITERE Quelldatei aufgerufen werden!
  276.  
  277.  
  278.   Grundsätzlich gilt ebenso:
  279.   ──────────────────────────
  280.   Wenn nicht  anders angegeben  (s. Option  -W oder -Z) gibt PROFIBATCH nach
  281.   Beendigung einen  ERRORLEVEL für  die Abfrage  in Batch-Programmen zurück.
  282.   Und zwar  immer den  ASCII-Wert des  letzten Tastendrucks!  (Eine Ausnahme
  283.   bildet  allerdingsdie   Taste  ESC  [s.  dort]...).  Haben  Sie  also  zum
  284.   'wegpoppen' des  Fensters die  Leertaste  gedrückt,  gibt  PROFIBATCH  den
  285.   ERRORLEVEL 32  zurück. Bei den Funktionstasten gelten als Rückgabewert die
  286.   Werte 1-10.  Durch die  Abfrage dieses  Rückgabewertes läßt sich in Batch-
  287.   Programmen  eine  große  Flexibilität  erreichen!  Bricht  PROFIBATCH  aus
  288.   irgendeinem  Grund   ab,  wird   als   Fehlerwert   der   ERRORLEVEL   254
  289.   zurückgegeben.
  290.  
  291.  
  292.   Aber jetzt solls doch endlich mal losgehen:
  293.   ───────────────────────────────────────────
  294.   Wir beginnen  gleich mit  einem praktischen Beispiel, damit Sie sehen, daß
  295.   Ihnen PROFIBATCH 'was bringt.
  296.  
  297.   Angenommen, Sie  haben für  Ihre Bekannten eine Diskette erstellt, auf der
  298.   Sie  allen   ein  gesegnetes  Osterfest  wünschen  möchten!  Dazu  ist  es
  299.   notwendig, daß  Sie ein  paar  Texte  (nämlich  die  Begrüßung  etc.)  und
  300.   vielleicht auch  ein paar  Bilder -  vielleicht von Ihrem Urlaub - zeigen.
  301.   Für die  Präsentation der  Bilder verwenden Sie eines der vielen Programme
  302.   auf dem  Markt - für die der Texte blieb Ihnen bisher nur der ätzende ECHO
  303.   - Befehl.
  304.   Aber von nun an wird das anders!
  305.   Sicher haben  Sie ganz  spezielle Wünsche,  aber hier  soll es  ja um  ein
  306.   Beispiel gehen.
  307.  
  308.   Texte erstellen können Sie mit folgendem Befehl:
  309.  
  310.   BWRITER <Textname.EXT>
  311.  
  312.   Textname.EXT ist der Dateiname, den Sie editieren wollen.
  313.   z.B.
  314.  
  315.   BWRITER hallo.doc erstellt die Datei HALLO.DOC (falls sie noch nicht
  316.   vorhanden ist) und Sie können Ihren Text eingeben.
  317.  
  318.  
  319.   ┌──────────────────┐
  320.   │ Text1: HALLO.DOC │
  321.   └──────────────────┘
  322.  
  323.   ------- schnipp -------------------------
  324.   Hallo Ihr Lieben! Zum diesjährigen Osterfest wünsche ich Euch allen alles
  325.   Gute und sonnige Feiertage! Jesus Christus ist nicht tot geblieben - also
  326.    könnt Ihr Euch freuen und braucht nicht im Bett liegen bleiben, sondern
  327.                     vielmehr zu meiner Osterparty kommen!
  328.  
  329.   Treffpunkt: Sonntag 10.oo Uhr Jakobuskirche, zum Gottesdienst.
  330.  
  331.   Anschließend: Osterspaziergang und Oster-Brunch bei mir.
  332.  
  333.                                   Open End!
  334.   ------- schnapp -------------------------
  335.  
  336.  
  337.   ┌─────────────────┐
  338.   │ Text2: MENU.DOC │
  339.   └─────────────────┘
  340.  
  341.   ------- schnipp -------------------------
  342.   Nochmal von vorne
  343.         ENDE
  344.   ------- schnapp -------------------------
  345.  
  346.   ┌─────────────────┐
  347.   │ Text3: ENDE.DOC │
  348.   └─────────────────┘
  349.  
  350.   ------- schnipp -------------------------
  351.  
  352.     Hoffentlich hat's hier auf der Disk ein bißchen Spaß gemacht. Der Spaß
  353.                    geht aber erst am Sonntag so richtig ab!
  354.                                Also: Bis dann!
  355.                                                                    Euer Apo.
  356.   ------- schnapp -------------------------
  357.  
  358.   Wenn Sie die drei Texte gespeichert haben, können wir loslegen.
  359.   Schreiben  Sie   folgendes  Batch-Programm.
  360.   Die  Kommentare (REM) können  Sie auch weglassen. Sie dienen nur zu
  361.   Ihrem Verständnis.
  362.  
  363.  
  364.   ┌──────────┐
  365.   │ DEMO.BAT │
  366.   └──────────┘
  367.  
  368.   ------- schnipp -------------------------
  369.   @echo off
  370.   REM DEMO FÜR MEINE FREU(N)DE
  371.  
  372.   :START
  373.   REM Bildschirm löschen und blau einfärben
  374.   pb -f -h1 -v15 -c
  375.  
  376.   REM Den ersten Text als Eingangsbildschirm präsentieren. Mit
  377.   REM rotem Hintergrund und weißer Schrift. Dazu ein Schatten und
  378.   REM eine Überschrift.
  379.   pb hallo.doc -h4 -v15 -s "-u Hi! "
  380.  
  381.   REM Wenn der Anwender nun eine Taste gedrückt hat, können Sie
  382.   REM weitere Operationen vornehmen. Beispielsweise eine Bild-Datei
  383.   REM mit einem Osterhasen anzeigen. Da das ganz auf Ihre Bilder
  384.   REM und Ihr Präsentationsprogramm ankommt, schreiben wir hier mal
  385.   REM bloß einen Directory-Auszug rein. Den Befehl 'DIR' können Sie
  386.   REM also nach Belieben ersetzen...
  387.   dir
  388.  
  389.   REM Wenn alles soweit fertig ist, soll der Anwender gefragt
  390.   REM werden, ob er genug hat, oder ob er alles noch einmal
  391.   REM von vorne anschauen möchte. Hierzu wird das Menü - der
  392.   REM dritte Text aufgerufen.
  393.   REM Mit der Errorlevel-abfrage können Sie genau verzweigen, je
  394.   REM nachdem was der Anwender angewählt hat. Mehr dazu lesen Sie
  395.   REM bitte bei der Erklärung zur Option -M!
  396.   pb menu.doc -h2 -v0 -s "-u Auswahl " -m
  397.   if errorlevel 254 goto ENDE
  398.   if errorlevel 2 goto ENDE
  399.   if errorlevel 1 goto START
  400.  
  401.   :ENDE
  402.  
  403.   REM Den dritten Text präsentieren.
  404.   pb ende.doc -h3 -v0 -s "-u Das war's "
  405.  
  406.   REM Und die DOS-Bildschirmfarben wieder setzen.
  407.   cls
  408.   ------- schnapp -------------------------
  409.  
  410.   Bitte beachten  Sie:
  411.  
  412.   Sie erhalten beim  Erstellen  der Bibliothek u.U. die Datei DEMO.COM. Da
  413.   das Betriebssystem DOS COM-Dateien vor BAT-Dateien als ausführbare Programme
  414.   startet, sollten Sie zum Starten der Demo immer die Endung .BAT mit angeben!
  415.  
  416.   Das   als    kleine   Einführung.    Umfassende   Hinweise    bietet   das
  417.   Informationssystem INFO.BAT.
  418.   Starten Sie INFO.BAT und gehen Sie Menü um Menü und Punkt für Punkt durch.
  419.   In einer  halben Stunde kennen Sie sich großartig in der PROFIBATCH-Syntax
  420.   aus. An  kleinen Beispielen sehen Sie gleich, welche Wirkung die einzelnen
  421.   Optionen haben.  Auch das  Informationssystem wurde ganz und gar mit einem
  422.   Textverarbeitungsprogramm und PROFIBATCH geschrieben...!
  423.  
  424.  
  425.  
  426.   Nun aber zu den einzelnen Optionen und Schaltern:
  427.   ─────────────────────────────────────────────────
  428.   Hinweis: Die  Optionen wurden  in alphabetischer  Reihenfolge beschrieben.
  429.   Das hat den Vorteil, daß Sie schnell eine Übersicht vor sich haben.
  430.   Außerdem beachten  Sie bitte,  daß im Folgenden die Begriffe "Steuerdatei"
  431.   und "Quelldatei"  synonym verwendet werden! Es handelt sich hierbei um die
  432.   Datei, die ein schnelles hintereinander - präsentieren von mehreren Texten
  433.   ermöglicht und mit dem Schalter -Q angesprochen wird.
  434.  
  435.   -A  wie ANHÄNGEN:
  436.   ─────────────────
  437.  
  438.   Voreinstellung: Nicht aktiviert.
  439.  
  440.   Angenommen,  Sie  haben  mit  der  Option  -e  eine  Bibliothek  erstellt.
  441.   Plötzlich fällt  Ihnen ein,  daß da  ja noch ein Text drin fehlt! Anstatt,
  442.   daß Sie  den Text  jetzt extra  wieder in der Quelldatei eintragen und die
  443.   Quelldatei neu  in eine  Bibiothek umwandeln,  benutzen  Sie  einfach  die
  444.   Option -a!  Die Option  -a wirkt  also nur in Verbindung mit der Option -e
  445.   und hängt  neue Texte  an schon  vorhandene Bibliotheken an. Geben Sie die
  446.   neue  Text   oder  Quelldatei   wie  gewohnt   an  und  ergänzen  Sie  die
  447.   Optionenliste durch die Option -a. Hierbei müssen Sie beachten, daß nach -
  448.   a der  Name der  Bibliothek erforderlich  ist, an  die das  Zeug angehängt
  449.   werden soll  (Bsp.:  PB  neuer.txt  -h3  -v0  -s  -e  -aPRESENT.LIB).  Die
  450.   Erweiterung .LIB  können Sie auch weglassen, wenn Sie zu faul dazu sind...
  451.   (Die Bibliothek,  die erweitert werden soll, muß es natürlich auch geben!)
  452.   Der neue  Text befindet sich als höchste Nummer (letzte Nummer + 1) in der
  453.   erweiterten Bibliothek.  Die Bibliothek,  die erweitert  wurde erhält  die
  454.   Endung .OLD (in unserem Beispiel also PRESENT.OLD).
  455.  
  456.  
  457.   -B  wie Breite:
  458.   ───────────────
  459.   Voreinstellung: 40 Zeichen.
  460.  
  461.   Die Option  -b findet nur in Verbindung mit Option -i Verwendung. Sie gibt
  462.   an, wie  breit das  Fenster für die Eingabe sein soll. Die maximale Breite
  463.   beträgt 80 Zeichen!
  464.  
  465.  
  466.   -C  wie CLEAR:
  467.   ──────────────
  468.   Voreinstellung: Nicht aktiviert.
  469.  
  470.   Der ursprüngliche Bildschirminhalt bleibt ja bei der Text-Präsentation mit
  471.   PROFIBATCH immer  erhalten. Wünschen Sie sich jedoch einen unbeschrifteten
  472.   Hintergrund, benutzen Sie die Option -c. Dies wirkt wie ein 'cls' auf DOS-
  473.   Ebene der  Cursor wird  in die linke obere Ecke gesetzt. In Verbindung mit
  474.   einem zu  präsentierenden Text  wird ERST der Bildschirm gelöscht und dann
  475.   der Text ausgegeben.
  476.   Einen gewichtigen  Vorteil gegenüber  'cls' hat  diese Option: Die aktuell
  477.   gesetzte Bildschirmfarbe  (s. Schalter  -F) wird  NICHT geändert  und  Sie
  478.   können innerhalb  von Quelldateien (s. Schalter -Q) den Bildschirm löschen
  479.   ohne dazu extra den DOS-Befehl anwenden zu müssen (also nix mit: im Batch-
  480.   Programm 'CLS' eingeben und dazu aus der Quelldatei austeigen müssen!).
  481.   Beachte: Da  sich die  Option -c auf den Bildschirm bezieht, darf sie AUCH
  482.   am ANFANG  stehen. Andere  Optionen beziehen  sich auf  Dateien und stehen
  483.   hinter einem Dateinamen.
  484.  
  485.  
  486.   -E  wie ERSTELLE BIBLIOTHEK:
  487.   ────────────────────────────
  488.  
  489.   Voreinstellung: Nicht aktiviert.
  490.  
  491.   Ganz neu  ist die Möglichkeit, viele Texte (die man sonst alle einzeln auf
  492.   Diskette /  Festplatte gespeichert hatte) in EINER Datei zusammenzufassen.
  493.   Und zwar lassen sich mit der Option -e entweder Texte aus einer Quelldatei
  494.   oder  nur  ein(e)  einzelne(r)  auszugebende(r)  Text/Anweisung  in  einer
  495.   Bibliothek  speichern!   Als  Bibliotheksname  wird  immer  der  Name  der
  496.   angegebenen Textdatei verwendet gleich, ob es sich um eine Text- oder eine
  497.   Quelldatei handelt.  Beispiel: 'PB steuer.str -e -q' erstellt zum Beispiel
  498.   die Bibliothek  'STEUER.LIB', die nun alle in der Quelldatei vorgekommenen
  499.   Anweisungen und  Texte gespeichert hat. Gleichzeitig (wenn nicht Option -a
  500.   aktiviert ist)  wird ein  Programm erstellt,  das den gleichen Namen trägt
  501.   und womit sie die Bibliothek benutzen können (In unserem Beispiel wäre das
  502.   das Programm 'STEUER.COM').
  503.  
  504.  
  505.   -F  wie FARBEN:
  506.   ───────────────
  507.   Voreinstellung: Nicht aktiviert.
  508.  
  509.   Diese Option  unterscheidet sich  grundsätzlich von  den anderen!  Deshalb
  510.   habe ich  sie auch  'Schalter' genannt. Sie bezieht sich nämlich NICHT auf
  511.   einen  auszugebenden   Text,  sondern   ausschließlich  auf  den  GESAMTEN
  512.   Bildschirm. Deshalb  steht sie auch ANSTELLE einer Textdatei direkt hinter
  513.   'PB', bzw.  am ANFANG  der (Quelldatei-)  Zeile. Mit  -f  können  Sie  den
  514.   gesamten  Bildschirm  einfärben.  Die  Option  -h  bezieht  sich  auf  den
  515.   Hintergrund, -v auf den Vordergrund.
  516.   Beachte: Beim  Einfärben des  Bildschirms wird  der Bildschirminhalt NICHT
  517.   gelöscht (vgl.  Option -C)!  Das hat  manche Vorteile: Sie können z.B. bei
  518.   Batch  Programmen   Bildschirmausgaben  aus   angewandten  Programmen   in
  519.   besonders  ansprechenden   Farben  ausgeben  lassen,  oder  diese  einfach
  520.   unterdrücken  (Hintergrund  und  Vordergrund  auf  den  gleichen  Farbwert
  521.   setzen). Durch  Farbänderung können  Sie später  so unterdrückte  Ausgaben
  522.   ohne weiteres wieder auf den Schirm 'zaubern'... Wollen Sie den Bildschirm
  523.   aber trotzdem  gleich löschen,  steht Ihnen  ja noch  die  Option  -c  zur
  524.   Verfügung. Der Schalter -F erkennt also nur die drei Optionen -h, -v und -
  525.   c (Beispiel: 'PB -f -c' entspricht 'CLS' in Batch-Programmen).
  526.  
  527.   Beispiele für den Schalter -F:
  528.   ──────────────────────────────
  529.   a)  -f -h3 -v14 Färbt nur den Bildschirm ein.
  530.   b)  -f -h3 -v14 -c Färbt und löscht den Bildschirm.
  531.   c)  -f Setzt die ursprünglichen Farben (weiß auf schwarz).
  532.   d)  -f -v0 Macht den ganzen Schirm dunkel.
  533.   e)  -f -h4 -v4 -c Löscht den Bildschirm, färbt ihn rot ein und unterdrückt
  534.       alle folgenden Ausgaben.
  535.  
  536.  
  537.   -Gi  wie MAUS INITIALISIEREN:
  538.   ─────────────────────────────
  539.  
  540.   Bevor Sie  mit der  Maus arbeiten  wollen, sollten Sie sie initialisieren.
  541.   Mit dieser  Funktion prüfen Sie, ob überhaupt eine Maus angeschlossen ist.
  542.   Ist KEINE Maus verfügbar, wird der ERRORLEVEL 1 zurückgegeben.
  543.  
  544.  
  545.   -G0  wie MAUS AUS:
  546.   ──────────────────
  547.   So wird die Maus wieder ausgeschaltet...
  548.  
  549.  
  550.   -G1  wie MAUS EINSCHALTEN:
  551.   ──────────────────────────
  552.   So kommt sie auf den Schirm...
  553.  
  554.  
  555.   -Gl  wie MAUS LESEN:
  556.   ────────────────────
  557.   Mit diesem  Schalter lesen  Sie die  Maus.  Das  bedeutet,  daß  so  lange
  558.   'nichts' passiert,  bis eine  Taste an  der Maus  gedrückt wurde.  Hat der
  559.   Benutzer dann  'was gedrückt,  werden die  aktuellen  Daten  in  folgenden
  560.   Umgebungsvariablen gespeichert:
  561.   MT = Taste (1 = linke, 2 = rechte, 3 = mittlere)
  562.   MX = Spalte
  563.   MY = Zeile
  564.  
  565.   Fragen Sie anschließend diese Variablen ab, können Sie den User zielsicher
  566.   in Menüs  und Untermenüs  hindurchführen... Zum gepflegten Programmierstil
  567.   gehört es übrigens, wenn Sie ganz am Ende Ihres Programmes diese Variablen
  568.   wieder löschen.
  569.   Beispiel: PB -gl
  570.  
  571.  
  572.   -Gs  wie MAUS SETZEN:
  573.   ─────────────────────
  574.   Damit läßt  sich die  Maus an  einen beliebigen Punkt auf Ihrem Bildschirm
  575.   setzen. Wie  üblich  fängt  er  mit  1/1  an  und  endet  mit  80/25.  Die
  576.  
  577.   Koordinaten geben  Sie nach  dem Schalter  wie gewohnt mit den Optionen -x
  578.   und -y an (Beispiel: PB -gs -x80 -y1).
  579.  
  580.  
  581.   -Gx  wie VERTIKALE EINSCHRÄNKUNG:
  582.   ─────────────────────────────────
  583.   Der Bereich, in dem sich die Maus bewegen soll, kann eingeschränkt werden.
  584.   Dabei gilt die Option x als Spalten-Minimum und die Option -y als Spalten-
  585.   Maximum (Beipiel: PB -gx -x1 -y1  -> jetzt kann man die Maus nur am linken
  586.   Rand hoch und runter fahren!).
  587.  
  588.  
  589.   -Gy  wie HORIZONTALE EINSCHRÄNKUNG:
  590.   ───────────────────────────────────
  591.   Der Bereich, in dem sich die Maus bewegen soll, kann eingeschränkt werden.
  592.   Dabei gilt  die Option -x als Zeilen-Minimum und die Option -y als Zeilen-
  593.   Maximum (Beipiel:  PB -gy  -x25 -y25  -> jetzt  kann man  die Maus  nur am
  594.   unteren Rand links und rechts fahren!).
  595.  
  596.  
  597.   Tip: Viele  Anwender wollen gleich Programme mit Maus erstellen. Damit Sie
  598.   zu Anfang nicht gefrustet sind, hier ein ganz kleines Beispiel:
  599.  
  600.   Schreiben Sie mit einem Ihrer Lieblingseditoren folgendes Menü und nennen
  601.   es MENU.DOC:
  602.  
  603.   ----schnipp-----------
  604.   Menüzeile - No. 1
  605.        Zeile 2
  606.        ENDE
  607.   ----schnapp-----------
  608.  
  609.   Daraufhin schreiben Sie das dazugehörige Batch-Programm:
  610.  
  611.   ----schnipp-----------
  612.   echo off
  613.   REM Erst mal den Bildschirm löschen
  614.   cls
  615.  
  616.   REM Die Maus initialisieren, wenn keine angeschlossen ist, aussteigen
  617.   pb -gi
  618.   if errorlevel == 1 goto KEINMAUS
  619.  
  620.   REM Das Menü sollte mit -x und -y genau postioniert werden,
  621.   REM damit die Mauspostion auch richtig abgefragt werden kann.
  622.   pb menu.doc -f -h1 -v15 -s -y8 "-u Bitte wählen Sie: " -o -x30 -y12
  623.  
  624.   REM Die Maus einschalten.
  625.   REM Erst das Menü, und dann die Maus setzen, da sonst der Hintergrund
  626.   REM verdorben ist...
  627.   :WARTEN
  628.   pb -g1
  629.  
  630.   REM Jetzt kann auf den Maustastendruck gewartet werden.
  631.   pb -gl
  632.   if errorlevel == 255 goto ENDE
  633.  
  634.   REM Die von PROFIBATCH gesetzten Maus-Variablen auswerten.
  635.   REM Druck auf die rechte Maustaste beendet das Programm!
  636.   if %MT%==2 goto ENDE
  637.   if %MT%==1 goto SPALTE
  638.  
  639.  
  640.   :KEINMAUS
  641.   GOTO ENDE
  642.  
  643.   :SPALTE
  644.   REM Hier wird die x-Position abgefragt, an der die Maus gedrückt
  645.   REM wurde.
  646.   for %%P in (32 33 34 35 36 37 38 39 40 41) do if %MX% == %%P goto ZEILE
  647.   for %%P in (42 43 44 45 46 47 48 49 50 51) do if %MX% == %%P goto ZEILE
  648.   goto WARTEN
  649.  
  650.   :ZEILE
  651.   REM Hier wird die y-Position abgefragt, an der die Maus gedrückt wurde.
  652.   REM Wenn Sie Lust haben, können Sie auch die Zeilen im Menü nach einem
  653.   REM korrekten Maustastendruck noch mit dem Zeilentext unterlegen...
  654.   REM Beispiel hier in Zeile 1. Aber vorher die Maus ausschalten!
  655.   set TMP=Menüzeile - No. 1
  656.   if %MY%==13 pb -g0
  657.   if %MY%==13 pb -nTMP -y13 -x32 -o -r0
  658.  
  659.  
  660.   if %MY%==13 echo Das ist Menüzeile - No. 1
  661.   if %MY%==13 goto WARTEN
  662.   if %MY%==14 echo Das ist Menüzeile - No. 2
  663.   if %MY%==14 goto WARTEN
  664.   if %MY%==15 goto ENDE
  665.   goto WARTEN
  666.  
  667.   :ENDE
  668.   pb -g0
  669.  
  670.   REM bitte auch die Variablen wieder aus der Umgebung löschen!
  671.   set TMP=
  672.   set MT=
  673.   set MX=
  674.   set MY=
  675.  
  676.   ----schnapp-----------
  677.  
  678.  
  679.   -H  wie HINTERGRUND:
  680.   ────────────────────
  681.   Voreinstellung: 0 (SCHWARZ).
  682.  
  683.   Folgende Werte sind möglich:
  684.  
  685.   0 SCHWARZ     4 ROT
  686.   1 BLAU        5 VIOLETT
  687.   2 GRÜN        6 BRAUN
  688.   3 CYAN        7 HELLGRAU
  689.  
  690.   Für monochrome Grafikkarten gelten folgende Werte:
  691.  
  692.   0 SCHWARZ     7 HELL
  693.  
  694.   Mit den  Farben 8-15 als Hintergrundfarbe lassen sich manchmal noch schöne
  695.   andere Effekte erzielen. Das überlasse ich aber Ihren Übungen!
  696.  
  697.  
  698.   -I  wie INPUT:
  699.   ──────────────
  700.   Voreinstellung: Nicht aktiviert.
  701.  
  702.   Die Option  -I ist  ein Schalter  und MUß  am Anfang  stehen!  Mit  diesem
  703.   Schalter können  Sie den  Benutzer zu EINGABEN veranlassen. Hierbei öffnet
  704.   sich ein  frei editierbares  Fenster, dessen  Aussehen Sie  wie bei  einem
  705.   Textfenster durch  die entsprechenden  Optionen bestimmen  können. Es  ist
  706.   jedoch nur  EINE Zeile  hoch ist.  Die Breite  des Fensters  bestimmen Sie
  707.   durch die Option -B (s. dort). Das Besondere ist nun dies, daß die Eingabe
  708.   einer Umgebungsvariablen  zugeordnet wird, die anschließend z.B. im Batch-
  709.   Programm weiterverwendet  werden kann.  Diese Variable  muß DIREKT nach -I
  710.   angegeben werden (Beispiel: PB -iVariable -x3 -y5 -b5 -h4 -v14). Existiert
  711.   die Variable  bereits in  der Umgebung, wird ihr Inhalt gleich ins Editor-
  712.   Fenster  übernommen.   Wollen  Sie   diese  Variable  in  Batch-Programmen
  713.   einsetzen, muß sie in %% stehen (Beispiel: if "%Variable%" == "A:").
  714.  
  715.   Beachte:
  716.   ────────
  717.   1) Diese Option  funktioniert so  richtig zuverlässig erst ab MS-DOS 3.2 /
  718.      PC-DOS 3.3  und DR-DOS 3.41. Bei allen anderen Betriebssystemen kann es
  719.      zu Komplikationen kommen!
  720.   2) Sollte die Umgebung zu klein sein, vergrößern Sie sie, indem Sie in der
  721.      Datei CONFIG.SYS  die Option  /E: nach  COMMAND.COM verwenden  (im  DOS
  722.      Handbuch  nachschauen!).  Zum  Beispiel:  SHELL=C:\COMMAND.COM  C:\  /P
  723.      /E:1024.
  724.   3) Das  Setzen  der  Umgebungsvariablen  durch  die  Option  -I  ist  eine
  725.      empfindliche Angelegenheit.  Starten Sie  PROFIBATCH deshalb  möglichst
  726.      nicht aus einer weiteren Kopie des Kommandoprozessors COMMAND.COM.
  727.   4) Für das  Löschen der  Variablen  sind  Sie  selbst  verantwortlich.  Es
  728.      empfiehlt sich eine Variable, sobald sie nicht mehr gebraucht wird, mit
  729.      'SET VARIABLE=' aus der Umgebung zu löschen.
  730.  
  731.  
  732.   -M  wie MENÜ:
  733.   ─────────────
  734.   Voreinstellung: Nicht aktiviert.
  735.  
  736.   Für ganz anspruchsvolle Gemüter git's die Option -M! Damit läßt sich jeder
  737.   beliebige Text  zu einem  Auswahlmenü umfunktionieren.  Jede Zeile ist ein
  738.   Menüpunkt, der  mit den  Cursortasten   und   angewählt werden kann. Ein
  739.   solches Menü  gibt keinen  ASCII-Wert als  ERRORLEVEL zurück,  sondern die
  740.   Position der  angwählten  Menüzeile  (von  oben  [=1]  nach  unten).  Eine
  741.   Menüzeile wird durch Drücken der RETURN-Taste ausgewählt. Danach poppt das
  742.   Fenster entweder  wieder weg, oder es bleibt, wenn die Option -O verwendet
  743.   wurde.  In   JEDEM  Fall   wird  die   unterlegte  Zeile   als  ERRORLEVEL
  744.   zurückgegeben.
  745.  
  746.  
  747.   -N  wie NAME:
  748.   ─────────────
  749.   Voreinstellung: Nicht aktiviert.
  750.  
  751.   Wollen Sie  mit SET oder der Option -I eingetragene Umgebungsvariablen auf
  752.   dem Bildschirm anzeigen, benutzen Sie die Option -N. Sie ist wie Option -I
  753.   ein sog.  Schalter, der am ANFANG der Zeile stehen muß. Gleich im Anschluß
  754.   an  'N'   muß  die   Variable  stehen   (Beispiel:  PB  -nVARIABLE).  Alle
  755.   nachfolgenden Optionen  beziehen sich  auf den  Inhalt der Variable, wobei
  756.   dieser wie ein von Diskette geladener Text behandelt wird. Einund Ausgaben
  757.   bei kleinen Abfragen sind nun ein Kinderspiel... Wie das konkret aussieht,
  758.   schauen Sie sich bitte unter der Option -I an!
  759.  
  760.  
  761.   -O  wie OHNE TASTENDRUCK
  762.   ────────────────────────
  763.   Voreinstellung: Nicht aktiviert.
  764.  
  765.   Gerade für  eine ansprechende  Präsentation ist  es unerläßlich  nicht nur
  766.   Fenster auf  den  Bildschirm  zu  bringen,  die  nach  Tastendruck  wieder
  767.   verschwinden, sondern  manchmal braucht  man unbedingt  auch Fenster,  die
  768.   eine Weile  dableiben. Mit  der Option  -o läßt  sich  dies  ganz  einfach
  769.   bewerkstelligen. Das  Fenster bleibt  dann  natürlich  so  lange  auf  dem
  770.   Bildschirm, bis  sie ihn  mit der  Option -c  oder auf andere Weise wieder
  771.   löschen!
  772.  
  773.  
  774.   -P  wie PIEP!:
  775.   ──────────────
  776.   Voreinstellung: Ausgeschaltet
  777.  
  778.   Manchmal ist  es notwendig,  den Benutzer  aus seinem  Bildschirmschlaf zu
  779.   wecken, um  ihn auf  etwas Besonderes hinzuweisen. Dafür ist die Option -p
  780.   gedacht es erfolgt ein Warnton.
  781.  
  782.  
  783.   -Q  wie QUELLDATEI:
  784.   ───────────────────
  785.   Voreinstellung: Nicht aktiviert.
  786.  
  787.   Damit das  Programm nicht  immer für  JEDEN Text extra geladen werden muß,
  788.   kann man sich sog. Quelldateien anlegen. Das sind normale Textdateien, die
  789.   nacheinander alle  Befehle enthalten,  die Sie sonst auf DOS-Ebene nach PB
  790.   eingeben würden.  Im Grunde  ist es  eine  Stapeldatei  für  das  Programm
  791.   PROFIBATCH, die  Zeilen werden nacheinander abgearbeitet. Dies vereinfacht
  792.   und beschleunigt  die Präsentation  von Texten  erheblich. Dabei  gilt die
  793.   gleiche Syntax  wie bei Eingabe auf DOS-Ebene mit dem Unterschied, daß die
  794.   Angaben hier  mit einem  Komma (,)  getrennt werden  müssen. Dies  hat den
  795.   Vorteil, daß  in einer  Überschrift ohne  weiteres  Leerzeichen  vorkommen
  796.   können. Die  angegebene Textdatei wird bei Verwendung von Schalter -q also
  797.   als QUELLDATEI interpretiert. Alle sonst angegebenen Optionen werden dabei
  798.   ignoriert, außer -e natürlich (Beispiel: PB steuer.dta -q).
  799.   Das Dienstprogramm  BAT2Q ist  Ihnen beim  Erstellen von  Quelldateien aus
  800.   Batch-Programmen sehr behilflich.
  801.  
  802.   Beachte:
  803.   ────────
  804.   Jede Steuerzeile  muß mit  einem RETURN  abgeschlossen sein! Die einzelnen
  805.   Angaben für  eine auszugebende Datei stehen also IMMER untereinander! Eine
  806.   Zeile darf  bis zu  128 Zeichen  enthalten und die gesamte Quelldatei darf
  807.   bis zu  500 Zeilen  haben. BEMERKUNGEN  können auch  eingefügt werden. Und
  808.   zwar  werden  sie  wie  bei  einem  Batch-Programm  mit  REM  eingeleitet.
  809.   Vergessen Sie  jedoch nicht  das KOMMA  danach, sonst gibt PROFIBATCH eine
  810.   Fehlermeldung aus.  Außerdem darf  der Name  REM nicht  für eine Text oder
  811.   Quelldatei verwendet werden! (Beispiel: REM, Dies ist der Kommentar.).
  812.   Es gibt immer wieder Probleme mit Leerzeilen! Beachten Sie also fernerhin,
  813.   daß Leerzeilen NICHT erlaubt sind!
  814.  
  815.  
  816.   Dies ist zum Beispiel ein Auszug aus einer Quelldatei...
  817.  
  818.   text1,-y1,-o,-h4,-v14,-r1,-u UND JETZT DER TEST
  819.   text2,-v3,-s,-y6,-x5
  820.   rem,
  821.   rem, Bildschirm löschen und färben
  822.   rem,
  823.   -f,-h1,-v15,-c
  824.   text3,-x1,-y1,-o,-v15
  825.   text4,-x1,-y4,-o,-v15
  826.   text5,-s,-v13
  827.   rem, Bildschirm schwarz
  828.   -f,-c
  829.   text6,-o,-h7,-v0,-x10,-y5
  830.   -f,-c
  831.   text7
  832.   text8,-u Beispiel
  833.  
  834.  
  835.   -R wie  RAHMEN:
  836.   ───────────────
  837.   Voreinstellung: 2 (doppelter Rahmen)
  838.  
  839.   Insgesamt stehen Ihnen vier Rahmenarten zur Verfügung:
  840.   -r0 = kein Rahmen
  841.   -r1 = einfacher Rahmen (-)
  842.   -r2 = doppelter Rahmen (═)
  843.   -r3 = leerer Rahmen ( )
  844.  
  845.  
  846.   -S  wie SCHATTEN:
  847.   ─────────────────
  848.   Voreinstellung: Ausgeschaltet.
  849.  
  850.   Wollen Sie  das Fenster dreidimensional simuliert dargestellt haben, geben
  851.   Sie s  ein. Bei  einer Farbgrafikkarte bleibt dabei die unter dem Schatten
  852.   befindliche Schrift  erhalten, verwenden  Sie eine monochrome Grafikkarte,
  853.   wird der Schatten mit dem Zeichen '▒' gebildet.
  854.  
  855.  
  856.   -U  wie UEBERSCHRIFT:
  857.   ─────────────────────
  858.   Voreinstellung: Keine Überschrift.
  859.  
  860.   Der Rahmen  um den  Text kann noch zusätzlich eine Überschrift beinhalten.
  861.   Die Überschrift  kommt oben  in die  Mitte des  Rahmens. Ihrer Kreativität
  862.   sind dabei  keine Grenzen  gesetzt. Sie  können alle  verfügbaren  Zeichen
  863.   verwenden. Für ansprechendes Layout sind Sie jedoch selbst verantwortlich!
  864.   Z.B. finde  ich es  doof,  wenn  die  Überschrift  direkt  an  den  Rahmen
  865.   anschließt (══Überschrift══).  Ist da  noch  ein  Leerzeichen  dazwischen,
  866.   sieht das  doch gleich  viel besser  aus (══ Überschrift ══)! Übrigens: Um
  867.   Leerzeichen verwenden  zu können,  benutzen Sie  entweder das  sog. 'harte
  868.   Blank' (ALT-255)  oder setzen Sie die Überschrift in Anführungszeichen. In
  869.   einer Quelldatei können Sie die Anführungszeichen auch weglassen.
  870.  
  871.     Beispiel DOS-Ebene: PB text "-u Das ist die Überschrift "
  872.    Beispiel Quelldatei: text,"-u Das ist die Überschrift ",-x1
  873.                   oder: text,-u Das ist die Überschrift ,-x1
  874.  
  875.  
  876.   -V  wie VORDERGRUND:
  877.   ────────────────────
  878.   Voreinstellung: 7 (HELLGRAU)
  879.  
  880.   Als Vordergrund,  d.h. als  Textfarbe eignen sich alle Farbwerte von 0-15.
  881.   Nachfolgend die Farben, die über die Farben der Option -H hinaus verwendet
  882.   werden können:
  883.  
  884.    8 DUNKELGRAU  12 HELLROT
  885.    9 HELLBLAU    13 HELLVIOLETT
  886.   10 HELLGRÜN    14 GELB
  887.   11 HELLCYAN    15 WEIß
  888.  
  889.   Außerdem können  Sie die Farbe durch Addierung des Farbwertes mit 128 auch
  890.   blinken lassen!
  891.  
  892.   Bei monochromen  Grafikkarten gilt  zu den  bei Option -H genannten Werten
  893.   noch der Wert 15, was besonders helle Schrift verheißt!
  894.  
  895.  
  896.   -W  wie WARTEN:
  897.   ───────────────
  898.   Voreinstellung: Nicht aktiviert.
  899.  
  900.   Manchmal möchte man, daß der Benutzer nur EINE einzige Taste drücken kann.
  901.   Selbstverständlich kann  man das  so bewerkstelligen,  daß in einem Batch-
  902.   Programm der  ERRORLEVEL  abgefragt  wird  und  danach  entweder  in  eine
  903.   Warteschleife oder weiter verzweigt wird. Um die Sache jedoch einfacher zu
  904.   gestalten, gibt's die Option -W. Das Fenster schließt sich erst dann, wenn
  905.   mindestens eine  von zwei  Bedingungen erfüllt  ist:  Entweder  die  Taste
  906.   'ESC', oder  die nach  -W angegebene  Taste wurde  gedrückt. Um  in  einem
  907.   Batch-Programm  beides  unterscheiden  zu  können,  gibt  PROFIBATCH  beim
  908.   Drücken der  angegebenen Taste  den Wert  der Taste  als ERRORLEVEL zurück
  909.   (Funktionstasten: 1-10). Das Drücken von 'ESC' ergibt ERRORLEVEL 255.
  910.   Der Benutzer  sollte im Fenster auf diese beiden Möglichkeiten hingewiesen
  911.   werden. Darüberhinaus erscheint rechts unten im Rahmen (falls einergesetzt
  912.   ist) eine  entsprechende Aufforderung  und die  Taste, die  gedrücktwerden
  913.   sollte.
  914.   Beachte: Durch diese Option kann man den Fortgang des Programms von
  915.   ──────── einem einzigen Tastendruck abhängig machen (denn 'ESC'beendet
  916.            ja bekanntlich das Programm)!
  917.  
  918.  
  919.   -X  wie SPALTE:
  920.   ───────────────
  921.   Voreinstellung: 0 (= in der Mitte)
  922.  
  923.   Geben Sie  die  gewünschte  Position  des  Fensters  an!  Die  Koordinaten
  924.   beziehen sich dabei auf die linke obere Ecke und zwar inklusive Rahmen und
  925.   Rand um  den Text. Deshalb kann es auch vorkommen, daß ein Text zwar klein
  926.   genug für die Bildschirmposition ist, wenn aber ein Rahmen oder vielleicht
  927.   sogar noch  ein Schatten  drum 'rum  soll, nicht mehr auf den Schirm paßt!
  928.   Der Bildschirm beginnt links mit 1 und endet rechts mit 80.
  929.  
  930.  
  931.   -Y  wie ZEILE:
  932.   ──────────────
  933.   Voreinstellung: 0 (= in der Mitte)
  934.  
  935.   Im Grunde  gilt für -y das Gleiche wie für -x, nur daß der Bildschirm oben
  936.   mit 1 beginnt und und unten mit 25 endet.
  937.  
  938.  
  939.   -Z  wie ZEIT:
  940.   ─────────────
  941.   Voreinstellung: 0 (auf Tastendruck warten).
  942.  
  943.   Mit dieser  Option können  Sie bestimmen,  wie lange  das Fenster  gezeigt
  944.   werden soll. Die Werte nach 'z' geben immer nur die SEKUNDEN an (Beispiel:
  945.   -z60 wartet eine Minute). Bei ZEITLICHEM Warten erscheint im Rahmen rechts
  946.   unten KEIN Text (so wie bei diesem hier...). Die Taste ESC unterbricht das
  947.   Warten und  PROFIBATCH kehrt  zum DOS zurück. Es gibt die Möglichkeit, das
  948.   Warten auch  zu überspringen  (beim Testen  ist das  sonst immer so ätzend
  949.   langweilig...): Geben  Sie anstatt  ESC  einfach  ALT-1  ein  (1  auf  dem
  950.   numerischen Tastenblock!).  PROFIBATCH beendet  daraufhin das  Warten  und
  951.   fährt im Programm fort.
  952.  
  953.  
  954.  
  955.   Allgemeine Themen:
  956.   ──────────────────
  957.   Warten auf einen Tastendruck:
  958.   ─────────────────────────────
  959.   Die Voreinstellung  der Option  -Z ist  0. Das  bedeutet, daß der Text auf
  960.   einen Tastendruck  des Benutzers  wartet. Es  bedeutet aber auch, daß NACH
  961.   dem Tastendruck  der Text wieder 'wegpoppt'. So lassen sich anspruchsvolle
  962.   Oberflächen schaffen. Wenn der Benutzer eine Taste drücken soll, erscheint
  963.   rechts unten  im Rahmen  die Aufforderung  dazu und  eventuell eine Taste,
  964.   wenn die  Option -W  verwendet wurde. Beachten Sie, daß dies alles NUR der
  965.   Fall ist,  wenn ein  RAHMEN angegeben ist! Auf diese Weise lassen sich mit
  966.   Unterdrückung des Rahmens ebenfalls originelle Effekte erzielen...
  967.  
  968.  
  969.   Grundsätzlich gilt bei Mausbenutzung:
  970.   ─────────────────────────────────────
  971.   Die in  PROFIBATCH implementierten  Mausfunktionen verstehen sich durchaus
  972.   nur als eine rudimentäre Angelegenheit. Allerdings läßt sich mit ein wenig
  973.   Geduld und Liebe zum Detail allerhand damit anstellen. Der Schalter -G ist
  974.   in verschiedene  UNTER-Schalter aufgeteilt,  die  ALLE  am  Anfang  stehen
  975.   müssen. Ein Tip zur Mausprogrammierung: Erstellen Sie sich mit der Eingabe
  976.   von 'PB  -g0 -e  ' ein  Programm, das  die Maus  ausschaltet. Anschließend
  977.   können Sie  das Programm -G0.COM und die Bibliothek -G0.LIB wie Sie wollen
  978.   umbenennen. Damit  haben Sie's  leichter, wenn irgendwann, beim Testen des
  979.   Batch-Programms ein Fehler auftritt und die Maus auf dem Schirm bleibt...
  980.  
  981.  
  982.  
  983.   Vielleicht noch  ein Wörtchen zur ESC-Taste:
  984.   ────────────────────────────────────────────
  985.   ESC  unterbricht   IMMER  die   Präsentation  egal   ob  als   einzelne(r)
  986.   Text/Angabe,  oder   in  einer   Quelldatei.  Dabei  gibt  PROFIBATCH  den
  987.   ERRORLEVEL 255  zurück, den  Sie in  einem Batch-Programm abfragen können.
  988.   ESC unterbricht  die Präsentation  auch wenn  NICHT auf  einen Tastendruck
  989.   gewartet wird.  Also angenommen  Sie lassen einen Text (durch die Angabe -
  990.   z30) 30 Sekunden auf dem Schirm warten und drücken währenddessen die Taste
  991.   ESC: dann  bricht PROFIBATCH  sofort die Präsentation ab und kehrt zu DOS,
  992.   bzw. zur Batch-Datei zurück.
  993.  
  994.  
  995.   Und noch ein Wörtchen zur Batch-Programmierung:
  996.   ───────────────────────────────────────────────
  997.   Immer wieder  tauchen Fragen  auf, wie  das denn mit den ERROROLEVELS geht
  998.   und sicher  möchten Sie  sich nicht  nächtelang die Haare raufen, weil Ihr
  999.   Programm absolut nicht das macht, was es eigentlich soll!
  1000.   Außer, daß  es dazu  ein hilfreiches  Buch gibt  (Heinz-Peter Gaß:  Batch-
  1001.   Programmierung unter  DOS. IWT-Verlag  1991), können  Sie  sich  auch  die
  1002.   folgenden Zeilen zu Gemüte führen:
  1003.   PROFIBATCH übergibt  beim Beenden,  also  wenn  z.B.  ein  Fenster  wieder
  1004.   geschlossen wird,  eine Zahl  an das Betriebssystem. Diesen Wert nennt man
  1005.   ERRORLEVEL, weil er meist für Fehlerwerte benutzt wird.
  1006.   Wenn Sie  in einem  Batch-Programm aufgrund  eines  ERRORLEVEL  verzweigen
  1007.   wollen, benutzen  Sie ja  bekanntlich den  Befehl IF  ERRORLEVEL...  Dabei
  1008.   müssen Sie  nun beachten,  daß DOS in einem Batch-Programm die ERRORLEVEL-
  1009.   Werte ABSTEIGEND  untersucht. Sie  müssen sich  das so vorstellen, daß ein
  1010.   Programm einen Wert zurückliefert und DOS nun von 255 bis 0 schaut, ob Sie
  1011.   mit dem Befehl IF ERRORLEVEL... irgendetwas anstellen wollen.
  1012.   Zur Praxis:  Sie wollen ein Menü erstellen, in dem Sie mit dem Tastendruck
  1013.   'g' irgendwelche  Spiele starten.  Dann schreiben  Sie  den  Menütext  und
  1014.   schreiben im Batchprogramm folgende Zeilen:
  1015.  
  1016.   PB menu -h4 -v15
  1017.   if errorlevel 103 goto GAMES
  1018.  
  1019.   Sollte der Anwender nun das 'g' drücken, wird zur Marke :GAMES gesprungen.
  1020.   ALLERDINGS! UND  DAS IST  JETZT GANZ  WICHTIG! Sollte der Anwender ein 'w'
  1021.   (ASCII 119) drücken, wird AUCH zur Marke :GAMES gesprungen! Und zwar liegt
  1022.   das eben  daran, daß  DOS erst  mal schaut,  ob Sie den Wert 119 abfragen.
  1023.   Wenn nicht,  wird beim  Wert 118  gefragt, wenn  da auch  nichts verzweigt
  1024.   wird, beim  Wert 117  und so  weiter, bis  DOS zum Wert 103 gelangt und da
  1025.   wird eben zur Marke gesprungen.
  1026.   Sie schränken  die Tasten  also immer  gezielt ein,  indem Sie  alle Werte
  1027.   oberhalb des  Tastenwertes "abfangen". In unserem Programm sähe es dann so
  1028.   aus:
  1029.  
  1030.   :START
  1031.   PB menu -h4 -v15
  1032.   if errorlevel 104 goto START
  1033.   if errorlevel 103 goto GAMES
  1034.  
  1035.   Sie sehen:  Wenn der  Anwender jetzt  ein 'w' drückt, kommt DOS irgendwann
  1036.   zum Wert  104 und  geht dann  wieder an  den Anfang.  So machen Sie es mit
  1037.   JEDER Taste, die gedrückt werden darf und Ihr Menü ist komplett.
  1038.  
  1039.  
  1040.   Fehlermeldungen:
  1041.   ────────────────
  1042.   Programm: Zu wenig Speicherplatz! Oder falsche Koordinaten!
  1043.   ───────────────────────────────────────────────────────────
  1044.   Das ist eine Programminterne Meldung, wird ausgelöst, wenn irgendetwas mit
  1045.   der Speicherbelegung nicht klappte. Überprüfen Sie die Koordinaten des
  1046.   Fensters. Meist erscheint diese Meldung, wenn ein Fenster über die Ränder
  1047.   hinaus dargestellt werden soll.
  1048.  
  1049.   (Dateiname): Zu viele Zeilen oder Spalten!
  1050.   ──────────────────────────────────────────
  1051.   Der Text, den Sie präsentieren wollen ist größer als 80 Spalten oder
  1052.   größer als 25 Zeilen.
  1053.  
  1054.   (Dateiname): Koordinaten überprüfen!
  1055.   ────────────────────────────────────
  1056.   Es wurden falsche Koordinaten angegeben.
  1057.  
  1058.   Umgebung: Kein Platz für weitere Variablen!
  1059.   ───────────────────────────────────────────
  1060.   Vergrößern Sie Ihre Prozessorumgebung! Näheres dazu können Sie am Anfang
  1061.   dieser Dokumentation lesen.
  1062.  
  1063.   Steuerdatei: Zeile zu lang! Mit <RETURN> abschließen!
  1064.   ─────────────────────────────────────────────────────
  1065.   Steuer-, bzw. Quelldateien müssen pro Zeile mit <RETURN> abgeschlossen
  1066.   werden.
  1067.   Dieser Fehler tritt jedoch meist dann auf, wenn Sie Leerzeilen in
  1068.   Steuerdateien einfügen. Achten Sie darauf, daß am ENDE der Quelldatei
  1069.   KEINE Leerzeile steht!
  1070.  
  1071.   (Parameter): Parameter überprüfen!
  1072.   ──────────────────────────────────
  1073.   Wie der Name schon sagt. Sie haben einen falschen Parameter verwendet!
  1074.  
  1075.   (Dateiname): Konnte Steuerdatei nicht öffnen!
  1076.   ─────────────────────────────────────────────
  1077.   Die Quelldatei steht nicht im angegebenen Verzeichnis.
  1078.  
  1079.   Steuerdatei: Zu viele Zeilen!
  1080.   ─────────────────────────────
  1081.   Die Quelldatei hat mehr als 500 Zeilen.
  1082.  
  1083.   (Bibiotheksname): Bibliothek nicht aufzufinden!
  1084.   ───────────────────────────────────────────────
  1085.   Die Bibliothek steht nicht im angegebenen Verzeichnis.
  1086.  
  1087.   (Bibliotheksname): Datei ist keine PROFIBATCH-Bibliothek!
  1088.   ─────────────────────────────────────────────────────────
  1089.   Entweder wurde eine Bibliothek früherer Versionen verwendet, oder Sie
  1090.   haben versucht die Bibliothek mit einem EXE-Packer zu komprimieren. Das
  1091.   geht aber nicht, weil für die Bibliotheken Overlay-Funktion bestehen muß.
  1092.  
  1093.   (Umgebungsvariable): Variable gibt's nicht!
  1094.   ───────────────────────────────────────────
  1095.   Sie haben eine unzulässige Umgebungsvariable angegeben. Prüfen Sie mit dem
  1096.   Befehl SET, ob sie überhaupt existiert.
  1097.  
  1098.   (Dateiname): Konnte Textdatei nicht öffnen!
  1099.   ───────────────────────────────────────────
  1100.   Der zu präsentierende Text steht nicht im angegebenen Verzeichnis.
  1101.  
  1102.   (Dateiname): Textdatei zu groß!
  1103.   ───────────────────────────────
  1104.   Der Text ist halt einfach viel zu groß....
  1105.  
  1106.   PBLIB.SRC: Nicht auffindbar!
  1107.   ────────────────────────────
  1108.   Für die Erstellung einer Bibliothek muß die Datei PBLIB.SRC im selben
  1109.   Verzeichnis wie PROFIBATCH stehen!
  1110.  
  1111.  
  1112.  
  1113.  
  1114.   ANHANG:
  1115.   ───────
  1116.  
  1117.   Zu den Bibliotheken:
  1118.   ────────────────────
  1119.   Haben Sie  eine Bibliothek mit der Option -E erstellt, stellt sich nun die
  1120.   Frage, wie  diese benutzen.  Das Einfachste  ist,  sie  rufen  (durch  das
  1121.   beigefügte Programm)  die Bibliothek  auf und  daraufhin werden ihnen alle
  1122.   Einträge hintereinander  präsentiert. So  kann man schnell und zuverlässig
  1123.   ein  Informationsprogramm   schaffen,  das   leicht  zu   lesen  und  dazu
  1124.   anschaulich ist.  Eine Bibliothek birgt aber noch zusätzliche Features: So
  1125.   lassen sich  auch AUSGEWÄHLTE  Einträge präsentieren,  oder nur die ersten
  1126.   drei etc. Die Einträge sind in der Bibliothek NUMERIERT. Und zwar gilt die
  1127.   Nummer 1  für den  ersten Eintrag  in der Quelldatei, die Nummer 2 für den
  1128.   zweiten usw.
  1129.  
  1130.   Nachfolgende Beispiele verdeutlichen die Möglichkeiten:
  1131.   (Beachten Sie  dabei, daß  entweder NUR Bindestriche oder NUR Plus-Zeichen
  1132.   verwendet werden können!)
  1133.  
  1134.   BIBLIO         Alle Einträge.
  1135.   BIBLIO 5       Nur der fünfte Eintrag.
  1136.   BIBLIO 1-6     Eintrag eins bis sechs.
  1137.   BIBLIO -6      dto.
  1138.   BIBLIO 1-      Alle Einträge.
  1139.   BIBLIO 3+8+2   Eintrag drei und acht und zwei.
  1140.  
  1141.   Sollten Sie  feststellen, daß  zwar der richtige Eintrag in der Bibliothek
  1142.   ist, aber die falschen Optionen gespeichert wurden, brauchen Sie auch hier
  1143.   NICHT wieder  alles in  der  Quelldatei  ändern  und  die  Bibliothek  neu
  1144.   erstellen. Hängen  Sie einfach die neuen Optionen an den Programmnamen mit
  1145.   der Eintragsnummer  an (so  wie  Sie  es  von  PROFIBATCH  gewohnt  sind)!
  1146.   Selbstverständlich sind  nicht ALLE Optionen wie bei PB verfügbar, aber so
  1147.   viele, daß  Sie ungehindert  walten können. Beachte: Ist bei einem Eintrag
  1148.   z.B. der  Schatten gesetzt,  schalten Sie ihn durch NOCHMALIGES Setzen der
  1149.   Option -S wieder aus! Dasselbe gilt für die Option -P.
  1150.  
  1151.   Beispiel: BIBLIO 3 -x1 -y4 "-u Die Änderung! " -s
  1152.  
  1153.   Und NOCH'N  Tip: Nacheinander  zu  präsentierende  Texte  laufen  mit  dem
  1154.   Bindestrich (3-5)  SCHNELLER ab, als mit dem Plus-Zeichen (3+4+5), denn da
  1155.   braucht nicht 'lange' gesucht werden!
  1156.  
  1157.   Es soll auch Leute geben, die MEHRERE Bibliotheken in EINEM Batch-Programm
  1158.   verwenden. Für die gibt's die Möglichkeit, nicht für jede Bibliothek extra
  1159.   ein Präsentierprogramm  auf der  Disk zu  halten, sondern ganz einfach nur
  1160.   EIN  Programm   zu  verwenden.   Das  Präsentierprogramm  ist  nämlich  so
  1161.   ausgelegt, daß  auch auf Bibliotheken mit ANDEREM Namen zugegriffen werden
  1162.   kann. Geben Sie zu diesem Zweck nach der Nummer einfach die Bibliothek an,
  1163.   auf  die   zugegriffen  werden   soll  (z.B.   STDBIBL  3-8   a:\NEWBIBL).
  1164.   Selbstverständlich  müssen   Sie  dabei  NICHT  auf  die  Möglichkeit  der
  1165.   Optionenänderung verzichten.  Wie gewohnt  können Sie  nach dem  Namen der
  1166.   neuen Bibliothek  auch Korrekturen an den Optionen vornehmen (z.B. STDBIBL
  1167.   3-8 a:\NEWBIBL -x1 -y1 -p).
  1168.  
  1169.  
  1170.   Dienstprogramme:
  1171.   ────────────────
  1172.  
  1173.   Das Programm LIB2TXT:
  1174.   ─────────────────────
  1175.  
  1176.   Syntax: LIB2TXT <Programmname[.LIB]> [<Ausgabename>] [/i]
  1177.  
  1178.   Auf Ihrer  Diskette befindet  sich  ein  kleines  Werkzeug,  das  Programm
  1179.   LIB2TXT. Es  dient dazu,  einmal erstellte  Bibliotheken  wieder  in  ihre
  1180.   Bestandteile aufzulösen.  So  brauchen  Sie  nicht  immer  alle  einzelnen
  1181.   Textdateien sichern, sondern können sich darauf verlassen, wenn sie einmal
  1182.   eingebunden sind, daß Sie sie wieder herauslösen können.
  1183.   Gleichzeitig wird  anhand der Bibliothek eine Quelldatei mit der Endung .Q
  1184.   erstellt.  Die  einzelnen  Texte  werden  durchnumeriert  und  die  Nummer
  1185.   Erscheint als  Erweiterung des  Dateinamens. Beachten  Sie,  daß  bei  der
  1186.   Expansion genügend Platz auf der Diskette sein muß! Im Normalfall wird als
  1187.   Text und Quelldateiname der Name der Bibliothek angenommen. Wenn Ihnen das
  1188.   zu unübersichtlich wird, können Sie auch einen NEUEN Textnamen bestimmen.
  1189.   Mit der  Option /i  können Sie  sich  vor  der  Expansion  noch  ein  paar
  1190.   Informationen 'reinziehen! Das kann ganz hilfreich sein, um den benötigten
  1191.   Speicherplatz zu ermitteln oder die letzte Eintragsnummer.
  1192.  
  1193.   ACHTUNG: Wie  Sie vielleicht bereits gemerkt haben, können Sie die bereits
  1194.   vorhandenen Bibliotheken auf Ihrer Diskette nicht mit LIB2TXT expandieren.
  1195.   Es sollte  der Fehler  "Bibliothek inkompatibel"  oder  "Falsche  Version"
  1196.   auftauchen. Das  hat seinen  berechtigten Sinn:  Nehmen Sie  mal  an,  Sie
  1197.   machen sich  die Mühe  und erstellen so ein Info-Programm, wie es INFO.BAT
  1198.   ist. Dann  wollen Sie  sicherlich nicht,  daß jeder PROFIBATCH-Benutzer es
  1199.   wieder zerpflücken  kann. Es  reicht bereits,  wenn er  in den Source-Code
  1200.   schauen kann. Deshalb werden Bibliotheken, die mit registrierten Versionen
  1201.   erstellt wurden  GRUNDSÄTZLICH gesperrt.  Nur Sie selbst können Sie wieder
  1202.   expandieren.
  1203.   Damit  Sie   dennoch  etwas   an  INFO.BAT   lernen  können,   wurden  die
  1204.   entsprechenden Steuerzeilen  als Bemerkungen  über  den  Bibliotheksaufruf
  1205.   geschrieben.
  1206.  
  1207.  
  1208.   Das Programm BAT2Q:
  1209.   ─────────────────────
  1210.  
  1211.   Syntax: BAT2Q <Batch-Programmname[.BAT]> [Optionen]
  1212.  
  1213.   Auf Ihrer  Diskette befindet  sich ein kleines Tool, womit Sie Ihre Batch-
  1214.   Programmierung mit PROFIBATCH erleichtern. Und zwar ist die Vorgehensweise
  1215.   am besten so:
  1216.   Sie schreiben  ein Batch-Programm  und verwenden  dabei  ganz  normal  das
  1217.   Programm PB.EXE.  Wenn alles  so klappt  wie Sie  wollen, starten  Sie zum
  1218.   Schluß BAT2Q  mit dem  Namen der  Batch-Datei. Aufgrund  der  Einträge  im
  1219.   Batch-Programm, erstellt BAT2Q - wie der Name schon sagt - eine Quelldatei
  1220.   mit der Endung .Q und bereitet Ihr Batch-File so auf, daß Sie es mit einer
  1221.   Text-Bibliothek und  dem  dazugehörigen  Runtime-Modul  zusammen  benutzen
  1222.   können.  Ihr  ursprüngliches  Batch-Programm  wird  mit  der  Endung  .OLD
  1223.   gesichert. Was  Sie also  danach nur noch tun brauchen: Mit PROFIBATCH aus
  1224.   der erstellten  Quelldatei eine  Bibliothek  machen.  Schon  ist  aus  dem
  1225.   langsamen Batch-Programm,  wo immer  wieder  PROFIBATCH  gestartet  werden
  1226.   mußte, ein  SCHNELLES Programm geworden! Beachten Sie aber, daß Ihr Batch-
  1227.   Programm nicht größer als 65 KB sein darf!
  1228.  
  1229.   WICHTIG!
  1230.   ────────
  1231.   Um Mißverständnissen  vorzubeugen:  BAT2Q  ist  KEIN  Batch-Compiler!  Sie
  1232.   benötigen zum  Ablauf also  IMMER  die  Batch-Datei  UND  die  PROFIBATCH-
  1233.   Bibliothek mitsamt dem Runtime-Modul!
  1234.  
  1235.   Nun zu den Optionen von BAT2Q:
  1236.   ──────────────────────────────
  1237.   BAT2Q beinhaltet  einige nutzenswerte  Variationen. Im Normalfall wird als
  1238.   Quelldateiname und  somit als  Eintrag im neuen Batchprogramm der Name der
  1239.   angegebenen Batch-Datei verwendet.
  1240.  
  1241.  
  1242.   Option /A:
  1243.   ──────────
  1244.   Mit der  Option /A können Sie den AUSGABE-Namen verändern (Beispiel: BAT2Q
  1245.   first.bat -Asecond). Sie haben es schon bemerkt: Die SYNTAX sind Sie schon
  1246.   von PROFIBATCH  gewohnt. Eine Option wird mir '/' oder '-' eingeleitet und
  1247.   wenn 'was dahinter soll, wird es gleich angeschlossen.
  1248.  
  1249.  
  1250.   Option /B:
  1251.   ──────────
  1252.   Haben Sie  bereits ein  Batch-Programm mit  BAT2Q bearbeitet,  wollen aber
  1253.   noch weitere  Einträge machen  und bei EINER Bibliothek bleiben, so tragen
  1254.   Sie  die  neuen  Angaben  wie  gewohnt  zum  Testen  mit  PROFIBATCH  ein.
  1255.   Anschließend können  Sie BAT2Q  wiederum verwenden.  Beachten  Sie  jedoch
  1256.   UNBEDINGT, daß  Sie zu  diesem Zweck  die Option /A benutzen müssen, sonst
  1257.   ist Ihre  erste Quelldatei  überschrieben! Mit  der Option  /B können  Sie
  1258.   dabei die  STARTNUMMER angeben,  mit der  die Einträge in der neuen Batch-
  1259.   Datei erfolgen  sollen. Anschließend  brauchen Sie  nur  noch  die  beiden
  1260.   Quelldateien zusammenbinden und mit PROFIBATCH eine Bibliothek machen.
  1261.  
  1262.  
  1263.   Option /E:
  1264.   ──────────
  1265.   Die Option /E versteht sich nur als Kompatibilität zu den anderen Optionen
  1266.   und kommt  der Eingabe  des Programmnamens  gleich hinter  'BAT2Q'  gleich
  1267.   (Beispiel: BAT2Q -Asecond -Efirst.bat).
  1268.  
  1269.  
  1270.   Option /K:
  1271.   ──────────
  1272.   Auf die  Option /K  folgen keine  Angaben. Der  Schalter bedeutet, daß die
  1273.   Einträge im  Batch-Programm soweit  wie möglich  KOMPRIMIERT werden. Dabei
  1274.   werden alle  mehrfach vorkommenden  Einträge in  der Quelldatei  zu  einem
  1275.   einzigen vereinigt. Die Bibliothek wird dadurch kleiner.
  1276.  
  1277.  
  1278.   Option /O:
  1279.   ──────────
  1280.   Mit der  Option /O OPTIMIEREN Sie Ihr Batch-Programm. Auch dieser Schalter
  1281.   erwartet  keine   Angaben.  Mit   /O  erhalten   Sie   einen   erheblichen
  1282.   Schnelligkeitsgewinn, da  alle aufeinanderfolgenden  Einträge mit '-' oder
  1283.   '+' vereinigt werden (Beispiel: BAT2Q first -o).
  1284.  
  1285.  
  1286.   Option /S:
  1287.   ──────────
  1288.   Normalerweise sucht  BAT2Q nach  dem  Programm  'PB'  um  nachfolgend  die
  1289.   Parameter in  die Quelldatei  zu schreiben.  Sie können  mit der Option /S
  1290.   auch nach  anderen SUCHWÖRTERN  schauen lassen.  Siese Option  macht  dann
  1291.   Sinn, wenn Sie mit mehreren Bibliotheken arbeiten wollen.
  1292.  
  1293.  
  1294.               Wir wünschen Ihnen noch viel Freude an PROFIBATCH!
  1295.  
  1296.                      W. Andreas Pollack - Eduard Klein
  1297.  
  1298.